home *** CD-ROM | disk | FTP | other *** search
/ Windows Game Programming for Dummies (2nd Edition) / WinGamProgFD.iso / mac / DirectX SDK / DXSDK / samples / Multimedia / DirectDraw / RefreshRate / readme.txt < prev    next >
Text File  |  2001-10-10  |  3KB  |  62 lines
  1. //-----------------------------------------------------------------------------
  2. // 
  3. // Sample Name: RefreshRate Sample
  4. // 
  5. // Copyright (c) 1999-2001 Microsoft Corporation. All rights reserved.
  6. // 
  7. //-----------------------------------------------------------------------------
  8.  
  9.  
  10. Description
  11. ===========
  12.     This example demonstrates basic usage of the IDirectDraw7::StartRefreshRate
  13.     and IDirectDraw7::EvaluateMode methods. Together, these methods allow an
  14.     application to explore what display modes and refresh rates the monitor
  15.     connected to this display device is able to display, though a manual
  16.     user-controlled process. The application will present the UI that asks
  17.     the user if the current mode under test is being displayed correctly by
  18.     the monitor.
  19.  
  20.     Applications should use these methods when they are interested in using
  21.     higher refresh rates.
  22.  
  23.     The basic idea is that DirectDraw will setup a list of modes to be tested
  24.     (based on the list the app passed in), and then sequentially test them
  25.     under application control. The app starts the test process, and then
  26.     calls IDirectDraw7::EvaluateMode continuously. DirectDraw will take care
  27.     of settings the modes. All the app has to do is SetCooperativeLevel
  28.     beforehand, and then handle surface loss and drawing the UI that asks the
  29.     user if they can see the current mode under test. DirectDraw returns
  30.     enough information from IDirectDraw7::EvalulateMode to allow the app to
  31.     know when to do these things, and when to stop testing. The app can pass
  32.     a flag to IDirectDraw7::EvaluateMode if the user happened to say they
  33.     could see the mode corretly, which will cause DirectDraw to mark the mode
  34.     as good and move on. DirectDraw may also decide that time as run out and
  35.     give up on a certain mode.
  36.  
  37.     DirectDraw uses information at its disposal from any automated means to
  38.     make the testing process as short as possible, and applications only need
  39.     to test modes they are interested in.
  40.  
  41. Path
  42. ====
  43.   Source: DXSDK\Samples\Multimedia\DDraw\RefreshRate
  44.  
  45.   Executable: DXSDK\Samples\Multimedia\DDraw\Bin
  46.  
  47. User's Guide
  48. ============
  49.   The user interface is a simple dialog box. First select the DirectDraw display
  50.   device.  Then select which modes you would like to test, and click 'Test'.   
  51.   Each display mode will be tested, and the user can select if the mode appears
  52.   correctly or not. 
  53.   
  54.   If the user makes a mistake, and accidently says YES when a mode cannot be seen, 
  55.   or NO when a mode really can be seen (thus ending up with a lower refresh rate than 
  56.   possible) this allows the user to reset the test results and try again.  
  57.   
  58.   Click the Exit button to exit the application.
  59.  
  60.   
  61.  
  62.